Inside Macintosh: QuickTime Components /

Chapter 9 - Movie Data Exchange Components / Movie Data Exchange Components Reference

Configuring Movie Data Import Components /

MovieImportDoUserDialog

The MovieImportDoUserDialog function allows an application to request that your component display its user dialog box.

pascal ComponentResult MovieImportDoUserDialog 
                              (ComponentInstance ci, 
                               const FSSpec *theFile, 
                               Handle theData, Boolean *canceled);

ci

Identifies the application's connection to your movie data import component.

theFile

Contains a pointer to a valid file specification. If the import request pertains to a file, the application must specify the source file with this parameter and set the parameter theData to nil. If the request is for a handle, this parameter is set to nil.

theData

Contains a handle to the data to be imported. If the import request pertains to a handle, the application must specify the source of the data with this parameter, and set the parameter theFile to nil. If the request is for a file, this parameter is set to nil.

canceled

Contains a pointer to a Boolean value. Your component should set this Boolean value to reflect whether the user cancels the dialog box. If the user cancels the dialog box, set the Boolean value to true. Otherwise, set it to false.

DESCRIPTION

Your movie data import component may support a user dialog box that allows the user to configure an import operation. For components that support such a dialog box, the MovieImportDoUserDialog function allows an application to tell you when to display the dialog box to the user.

If your component supports a user dialog box, be sure to set the hasMovieImportUserInterface flag in your component's componentFlags field.

RESULT CODE

badComponentSelector

0x80008002

Function not supported

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help